home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / edit / edwin15c.zip / EDWIN.DOC < prev    next >
Text File  |  1987-02-10  |  50KB  |  1,159 lines
  1. 1. Introduction
  2. ================================================================
  3.  
  4. EDWIN is a programmer's editor based on the Borland Editor
  5. Toolbox. It offers multiple editing windows and buffers, block
  6. moves between windows, undeletion, online help, Pascal structure
  7. editing, macro record and playback, DOS invocation from the
  8. editor, and file size limited only by available RAM.
  9.  
  10. For IBM PC and true compatibles. Keystrokes are WordStar
  11. compatible by default, but are fully configurable. Works with
  12. monochrome or color cards. Requires 256K.
  13.  
  14. A. New Features
  15. ---------------
  16.  
  17. Relative to version 1.3, this version of EDWIN has the following
  18. new features:
  19.  
  20.   Whenever you are prompted for a file name, you can enter the
  21.   name of a drive, directory, or wildcarded file specification.
  22.   EDWIN will pop up a window showing the matching files, and you
  23.   can select one via the Up and Down arrows and the <Enter> key.
  24.  
  25.   In adding the popup directory picker, we irrevocably exceeded
  26.   Turbo's 64K code segment. As a result, EDWIN now has a single
  27.   overlay file, EDWIN.000. This file must be kept in the same
  28.   drive and directory as the other EDWIN support files. The
  29.   specific location can be specified using the installation
  30.   program EDWINST.
  31.  
  32.   Scrolling performance has been improved on CGA adapters. The
  33.   screen is not updated continuously, but just once for each
  34.   required change.
  35.  
  36.   6 windows are enabled. A zoom mode allows the current window
  37.   to grow to fill the full screen, hiding any other files until
  38.   zoom is toggled again.
  39.  
  40.   The window status line has been redesigned. New information
  41.   includes the bytes used up to the cursor location, and a
  42.   "save flag" indicating when the file has been changed, as well
  43.   as a zoom indicator.
  44.  
  45.   The text cursor now can be installed in either of two modes. A
  46.   non-blinking solid cursor of any color can be chosen.
  47.   Alternatively, the blinking hardware cursor changes size to
  48.   indicate whether the editor is in insert mode (fat cursor) or
  49.   overwrite mode (thin cursor). The BIOS is kept fully informed
  50.   of all cursor positions and modes in order to work better with
  51.   memory resident writer's assistants.
  52.  
  53.   A default macro file, EDWIN.MAC, is automatically loaded into
  54.   memory when the editor is started. The EDWIN.MAC we supply
  55.   includes macros for indenting and unindenting text and
  56.   inserting standard Pascal constructs (procedure, function,
  57.   program, register set) into a program. A full blown macro
  58.   editor is incorporated into the installation program EDWINST.
  59.   This macro editor can be used at any time to generate new
  60.   macro files. The macro record mode within EDWIN is still
  61.   supported.
  62.  
  63.   The keyboard remains fully reconfigurable. The installation
  64.   program now automatically generates a help file matching the
  65.   current keyboard installation. The installation program now
  66.   has an option for "fast install." This sequentially prompts
  67.   for each entry, and is the desirable method if you are
  68.   reconfiguring many keys from the WordStar version.
  69.  
  70.   To save code space and add generality, the help facility now
  71.   treats the help file just like any other file or window.
  72.   Pressing the help command sequence opens a new window, reads
  73.   the help file from the installed directory, and lets you do
  74.   any EDWIN commands within that file. Note that you can modify
  75.   the file if you see fit. To exit help, press the Quit file
  76.   command (by default, ^K^Q).
  77.  
  78.   The EDWIN search algorithm now allows searching for the end of
  79.   line, which is found with the key combination ^M^J
  80.   (carriage return/line feed). This makes design of certain
  81.   macros feasible, including the autoindent marked block macro
  82.   which is supplied.
  83.  
  84.   A "Delete no recourse" command was added. This deletes the
  85.   current line without putting it on the undo stack. It is bound
  86.   to the Ctrl-Del key combination by default, so watch out!
  87.  
  88.   If you have previously reconfigured KEY files or macro files from
  89.   earlier versions of EDWIN, these will need to be rebuilt. The
  90.   addition of new commands, and a change in the format of macro
  91.   files, make this necessary.
  92.  
  93.   Other smaller improvements will become apparent when you use
  94.   the editor.
  95.  
  96.   A number of small bugs, and a couple of not so small ones have
  97.   been fixed. These include:
  98.  
  99.     Wasteful memory allocation when many newlines are inserted
  100.     at the end of a line.
  101.  
  102.     Occasional crashes or a weird flashing of the current line
  103.     after a marked or global replace.
  104.  
  105.     Odd placement of the cursor on the top command line, or
  106.     mangled text messages there.
  107.  
  108.     Paragraph reformat wrong for the last paragraph of a file.
  109.  
  110.     Invalid parsing of filenames using the ..\ or .\ prefixes.
  111.  
  112.     Block markers set incorrectly after blockreading a file
  113.     into a file.
  114.  
  115.     ^QL (Restore line) not setting the "modified" flag.
  116.  
  117.     Multiple windows onto a single file causing a crash when
  118.     significant deletion was done in one window.
  119.  
  120.  
  121. B. Support
  122. ----------
  123.  
  124.     This program was written by Kim Kokkonen of TurboPower
  125.     Software and is supported on a hobby basis. We will
  126.     appreciate your suggestions and comments, but cannot promise
  127.     support.
  128.  
  129.     This program has been released to the public domain for
  130.     personal, non-commercial use only. You may use it yourself,
  131.     give it to your friends or co-workers, or distribute it for
  132.     a cost-based fee as part of a user's group or bulletin board
  133.     service. If you wish to distribute this program as part of a
  134.     commercial package, please contact us for a license
  135.     agreement.
  136.  
  137.     If you ask for support or updates of this program, please
  138.     expect to make enough of a donation to cover our costs. We
  139.     will ask $10 to send you the latest version of the program.
  140.  
  141.     Our business number is 408-438-8608, and is answered
  142.     Monday-Friday 9AM to 5PM Pacific time. We can also be
  143.     reached via CompuServe [72457,2131].
  144.  
  145.     Our real business is the development of tools for Turbo
  146.     Pascal programmers. Our products include:
  147.  
  148.       TurboPower Utilities - 9 programs: Pascal Structure
  149.       Analyzer, Pretty Printer, Execution Profiler, Execution
  150.       Timer, File Compare, Regular Expression Find and Replace,
  151.       Super Directory, File Finder, Command Repeater.
  152.  
  153.       Turbo EXTENDER - offers 640K code model (with overlay
  154.       support as well) for Turbo. Also large data arrays, up to
  155.       30 megabytes. Plus a disk cache toolbox, a program to
  156.       analyze overlayed Turbo programs, a Pascal source code
  157.       encryptor, and more.
  158.  
  159.       T-DebugPLUS - a source level debugger for Turbo Pascal.
  160.       For sub-64K programs, the debugger integrates into the
  161.       Turbo development environment and provides the ability to
  162.       breakpoint on source statements or procedures, as well as
  163.       the ability to examine and change variables using normal
  164.       Pascal syntax. For Turbo EXTENDER programs, or for those
  165.       requiring the services of a machine level debugger, the
  166.       debugger creates a DOS-standard symbol file for the
  167.       program, allowing use of other symbolic debuggers such as
  168.       Symdeb, Atron and Periscope.
  169.  
  170. C. Acknowledgments
  171. ------------------
  172.  
  173.     Many thanks to the following people for their aid in the
  174.     development of EDWIN: Bela Lubkin (DOS EXEC function,
  175.     Command editor, DOS Critical error handler, mucho beta
  176.     testing), Randy Forgaard (fast text search), and Brian Foley
  177.     (fast CGA screen writer). And of course to Borland for the
  178.     Editor Toolbox in the first place.
  179.  
  180. D. Table of Contents
  181. --------------------
  182.  
  183. This document is organized as follows:
  184.  
  185.      1. Introduction
  186.      2. Installation
  187.      3. EDWIN Overview
  188.      4. Cursor Movements
  189.      5. Quick Movements
  190.      6. Inserting and Deleting
  191.      7. Find and Replace
  192.      8. Files and DOS
  193.      9. Windows
  194.      10. Blocks and Markers
  195.      11. Macros
  196.      12. Toggles
  197.      13. Text Processing
  198.      14. Final Notes and Cautions
  199.  
  200.  
  201.  
  202. 2. Installation
  203. ==============================================================